.. _ceGnEmergency_Set:

ceGnEmergency_Set
=================
-----------------


SYNOPSIS
--------


.. code-block:: none

  VT_I4 ceGnEmergency_Set(
    VT_I4 NodeID,
    VT_I4 State
  )



DESCRIPTION
-----------


- 해당 원격 노드에 소프트웨어 Emergency 를 설정하거나 해제합니다.

- 소프트웨어적인 Emergency 는 EMG 센서의 설치가 용이하지 않을 때 안전을 위하여 소프트웨어 Emergency 상태를 설정하는 것입니다. 소프트웨어 Emergency 상황을 설정하면 모션이 감속 없이 비상 정지 합니다.



PARAMETER
---------


- NodeID : 원격 노드 ID. 소프트웨어 Emergency 상태를 설정할 원격 노드 ID 를 설정합니다. 

- State : 이 매개변수를 통해 소프트웨어 Emergency 설정 혹은 설정된 상태를 반환합니다. 

+--------------+------------------------------+
| Value        | Meaning                      |
+==============+==============================+
| 0 (CE_FALSE) | 소프트웨어 Emergency 비활성. |
+--------------+------------------------------+
| 1 (CE_TRUE)  | 소프트웨어 Emergency 활성.   |
+--------------+------------------------------+


RETURN VALUE
------------

+----------------+-------------------------------------------------------+
| Value          | Meaning                                               |
+================+=======================================================+
| 음수           | 수행 실패. 자세한 내용은 '에러 처리' 편을 참고합니다. |
+----------------+-------------------------------------------------------+
| 0 (ceERR_NONE) | 수행 성공                                             |
+----------------+-------------------------------------------------------+



Example
-------
.. code-block:: cpp
 :linenos:
 C/C++
 #include “ceSDK.h”
 #include “ceSDKDef.h”
 void OnSetSwEmergency ()
 {
 long nNodeID = 1; // 해당 원격 노드 ID.
 long nSwEmgStatus; // 해당 원격 노드 모션 모듈의 소프트웨어 Emergency 상태 정보.
 /* 해당 노드의 소프트웨어 Emergency 설정 상태를 확인한 후, 설정된 상태에 따라 
 소프트웨어 Emergency 상태 설정 또는 해제 합니다. */
 if ( ceGnEmergency_Get ( nNodeID, &nSwEmgStatus ) == ceERR_NONE )
 {
  switch ( nSwEmgStatus )
  {
   case CE_FALSE : // 소프트웨어 Emergency 비활성 상태
   ceGnEmergency_Set ( nNodeID, CE_TRUE );
   break;
   case CE_TRUE : // 소프트웨어 Emergency 활성 상태
   ceGnEmergency_Set ( nNodeID, CE_FALSE );
   break;
    }
  }
 }